home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / nntpd / man / relaynews.8 < prev    next >
Text File  |  1995-08-16  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4. RELAYNEWS(8CN)                                     RELAYNEWS(8CN)
  5.  
  6.  
  7. NAME
  8.        relaynews - store and forward netnews articles
  9.  
  10. SYNOPSIS
  11.        uunews:bin/relay/relaynews  [  -hsux ] [ -a dupsite ] [ -b
  12.        xrefsite ] [ -c currdir ] [ -d fhlmt ] [ -o days ]
  13.  
  14. DESCRIPTION
  15.        Relaynews installs locally and broadcasts  (network)  news
  16.        articles  read  from  its  standard  input.  Typically the
  17.        articles will be in a batch (see news(5)), which must  not
  18.        be  compressed  (see  compress(1)).   Articles are usually
  19.        queued for transmission to one's  netnews  neighbours  via
  20.        newsbatch(8CN) and thence via uux(1) or snntp(1).
  21.  
  22.        -d  turns on debugging of filing, headers, locking, match-
  23.        ing, transmission.   -h  prevents  generation  of  history
  24.        entries  for rejected articles; the default behaviour gen-
  25.        erates larger history files that allow NNTP  receivers  to
  26.        more  efficiently  reject offered articles.  -s makes dis-
  27.        carding an article a serious matter, justifying a non-zero
  28.        exit  status (for the benefit of inews).  -c is an optimi-
  29.        sation: currdir is assumed to be the current directory; in
  30.        the  absence  of  this option, pwd is invoked.  -u unlinks
  31.        (removes) any filename arguments after successful process-
  32.        ing;  they are assumed to be relative to currdir (`pwd` if
  33.        none).  -o causes articles with dates (in  Date:  headers)
  34.        more than days old to be dropped (usually to stop acciden-
  35.        tally-retransmitted old articles).
  36.  
  37.        -x prevents generation of Xref: headers in articles  filed
  38.        in  exactly  one newsgroup; use of this option will inter-
  39.        fere with generation of news overview data  and  mirroring
  40.        via -b.  -b causes relaynews to not update active and file
  41.        articles received directly from xrefsite under the  groups
  42.        and  article  numbers found in incoming Xref: headers.  -b
  43.        provides the basis for a news mirroring facility.  -a sim-
  44.        ilarly causes active to not be updated and duplicate arti-
  45.        cles received directly from dupsite to  be  accepted,  but
  46.        filed  under the filenames found in their existing history
  47.        entries.  It may be used to recover a  news  spool,  given
  48.        recent active and history files.
  49.  
  50.        Control messages, recognised by their Control: headers are
  51.        filed under the control pseudo-group only,  but  are  for-
  52.        warded  as  usual, by examining their Newsgroups: and Dis-
  53.        tribution: headers.  Note  that  posting  to  the  control
  54.        pseudo-group  will  not cause a message to be treated as a
  55.        control message; control is not a real newsgroup.
  56.  
  57.        An article  which  contains  an  Also-Control:  header  is
  58.        treated  normally  except  that the contents of the header
  59.        are executed as if they were the contents  of  a  Control:
  60.        header.  Such an article is a form of hybrid message since
  61.  
  62.  
  63.  
  64.                          10 October 1993                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RELAYNEWS(8CN)                                     RELAYNEWS(8CN)
  71.  
  72.  
  73.        it functions as an ordinary article yet also  causes  con-
  74.        trol  functions to be executed.  The Supersedes: header is
  75.        a special case and is rewritten internally only  to  Also-
  76.        Control: cancel.
  77.  
  78.        Articles  which  contain  no  locally-known (to the active
  79.        file) newsgroups yet accepted by  the  local  subscription
  80.        list are filed exactly once, in the junk pseudo-group, and
  81.        forwarded as usual.  If all newsgroups in the article  are
  82.        refused  by  the local subscription list or are refused by
  83.        an x in active file entries, then the article will be dis-
  84.        carded and not filed in junk.
  85.  
  86.        Locally-generated  articles  need  not be permitted by the
  87.        local subscription list but are otherwise  processed  nor-
  88.        mally;  this  is for backward compatibility and perhaps to
  89.        keep the local subscription list short  by  not  requiring
  90.        general and the like to be named.
  91.  
  92. EXAMPLES
  93.        cd uunews:/in.coming
  94.        relaynews -uc uunews:/in.coming -o 7 nntp.* >>uunews:/log 2>>uunews:/errlog"
  95.             File  and forward articles in batches that arrived by
  96.             NNTP, and remove each batch  upon  successfully  pro-
  97.             cessing  it.   Discard  any articles more than a week
  98.             old.
  99.  
  100. FILES
  101.        uunews:             netnews article tree
  102.        uunews:/comp/unix/wizards
  103.                            example   newsgroup   directory   (for
  104.                            comp.unix.wizards);  such  directories
  105.                            and their ancestor directories will be
  106.                            created automatically as needed
  107.        uunews:/comp/unix/wizards/12564
  108.                            example article file name
  109.        uunews:/out.going/system/togo
  110.                            default  sys  file F, f, n and I flags
  111.                            batch      file      name       (N.B.:
  112.                            uunews:/out.going/system  will  not be
  113.                            automatically created as needed)
  114.        uunews:/sys         determines who receives broadcast net-
  115.                            news  articles,  which  ones,  and how
  116.                            they are to be sent articles
  117.        uunews:/active      contains locally-legal newsgroups  and
  118.                            (un)moderated flag
  119.        uunews:/history     record  of  articles received and map-
  120.                            ping of message-ids to file names
  121.        uunews:/history.{dir,pag}
  122.                            dbm(3Z) index into history by message-
  123.                            ids
  124.        uunews:/whoami      if  present,  contains  news  system's
  125.                            site name, overriding any  other  host
  126.                            names
  127.  
  128.  
  129.  
  130.                          10 October 1993                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RELAYNEWS(8CN)                                     RELAYNEWS(8CN)
  137.  
  138.  
  139.        uunews:/log         conventional log of incoming articles
  140.        uunews:/errlog      conventional  log of errors, should be
  141.                            empty
  142.        uunews:/headers     article headers of the last  relaynews
  143.                            invocation;   consumed   to   generate
  144.                            overview data
  145.        uunews:/bin         system-specific directory of  programs
  146.                            to  override uunews:bin and its subdi-
  147.                            rectories
  148.        uunews:bin/ctl      directory  of  programs  to  implement
  149.                            control messages
  150.        uunews:bin/relay/relaynews
  151.                            the lean, mean news-relayin' machine
  152.        uunews:bin/newsreply
  153.                            generates  a return address from arti-
  154.                            cle headers uunews:/replyusepath tells
  155.                            newsreply   to  use  the  Path  header
  156.                            rather than the From  header  for  the
  157.                            return address
  158.  
  159. SEE ALSO
  160.        compress(1),    snntp(1),    uux(1),   dbm(3Z),   news(5),
  161.        newsdb(5), newsbatch(8CN), rnews(8CN)
  162.        ARPA Internet RFCs 1036 and 850
  163.  
  164. DIAGNOSTICS
  165.        Usually found in uunews:/errlog.
  166.        Relaynews's exit status is 0 for successful completion,  1
  167.        if at least one batch was bad and worth manual inspection,
  168.        and 2 if the news system needs human attention.
  169.        If relaynews cannot establish safe standard file  descrip-
  170.        tors  and standardise its environment (notably PATH, SHELL
  171.        and IFS), probably due to failure of  malloc(3),  it  will
  172.        exit  with  status of 1 and without writing any complaints
  173.        on standard error (errlog), as a (possibly-obsolete) secu-
  174.        rity precaution.
  175.  
  176. HISTORY
  177.        Written  by  Geoff Collyer at the University of Toronto as
  178.        part of the C news project.
  179.  
  180. BUGS
  181.        A control message which cannot be  filed  in  the  control
  182.        pseudo-group and which cannot be filed in the junk pseudo-
  183.        group because junk is not in the active file will generate
  184.        an  error  message which refers to the groups in its News-
  185.        groups: header instead of referring to the control pseudo-
  186.        group.
  187.  
  188.        Relaynews could run faster in some circumstances and would
  189.        be simpler if Control:  were  required  to  be  the  first
  190.        header, if present, and if Newsgroups: were required to be
  191.        the next.
  192.  
  193.  
  194.  
  195.  
  196.                          10 October 1993                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RELAYNEWS(8CN)                                     RELAYNEWS(8CN)
  203.  
  204.  
  205.        The whole control message and hybrid message situation  is
  206.        a festering bug.  Either control messages should be elimi-
  207.        nated, or all forms of backward  compatibility  should  be
  208.        dropped  (including  Control:  and  Supersedes:)  and only
  209.        Also-Control: should be supported.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                          10 October 1993                        4
  263.  
  264.  
  265.